feat: partial hydration by avivkeller · Pull Request #951 · nodejs/doc-kit

avivkeller · 2026-07-27T23:35:52Z

Uses islands from 11ty in order to give us partial hydration

cursor · 2026-07-27T23:35:57Z

PR Summary

Medium Risk
Changes the web generator’s SSR/hydration and bundling model for all pages; regressions could affect interactivity, styling timing, or MDX components like CodeTabs.

Overview
Replaces full-page Preact hydration with partial hydration using @11ty/is-land. Interactive UI is wrapped in islands that hydrate on idle (banner, sidebar, theme) or on pointer/focus/touch (search, code copy, code tabs), while static markup stays in the HTML.

Adds withIsland, a Preact island runtime (registerIslands, dynamic loaders, slot-based child adoption), and wires Banner, ThemeToggle, SearchBox, SideBar, CodeBox, and CodeTabs through it. CodeTabs is vendored locally so it can be island-wrapped (fixes broken tabs when only partial JS loads).

The client bundle is now a single shared entry that registers all island loaders instead of one hydrate program per page; SSR still emits per-page programs but only imports components used on that page. Vite client builds set cssCodeSplit: false so styles are not tied to late-loading island chunks. Layout always renders Banner (no longer gated on client-only server flag).

Bumps @node-core/rehype-shiki and @node-core/ui-components; lockfile reflects transitive Radix/React patch updates.

^{Reviewed by Cursor Bugbot for commit 7282006. Bugbot is set up for automated code reviews on this repo. Configure here.}

vercel · 2026-07-27T23:35:59Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
api-docs-tooling	Ready	Preview	Jul 30, 2026 11:37pm

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
nodejs-doc-kit	Ignored		Jul 30, 2026 11:37pm

codecov · 2026-07-27T23:38:07Z

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 86.63%. Comparing base (70b7526) to head (7282006).
⚠️ Report is 1 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #951      +/-   ##
==========================================
+ Coverage   86.50%   86.63%   +0.13%     
==========================================
  Files         195      195              
  Lines       17964    17946      -18     
  Branches     1632     1635       +3     
==========================================
+ Hits        15540    15548       +8     
+ Misses       2418     2392      -26     
  Partials        6        6

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

cursor

Cursor Bugbot has reviewed your changes using default effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 797e8af. Configure here.}

Copilot

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

Copilot

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

Copilot

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

Copilot

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

Copilot

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

Copilot

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

ovflowd · 2026-07-30T11:05:31Z

@avivkeller is this fully working or on a ready state? I see the blocked label?

ovflowd · 2026-07-30T11:07:00Z

Is it only shiki broken?

avivkeller · 2026-07-30T15:15:06Z

@avivkeller is this fully working or on a ready state? I see the blocked label?

It's ready for review, since the implementation on this side is done, but can't land until nodejs/nodejs.org#9028 nodejs/nodejs.org#9047 to

avivkeller · 2026-07-30T21:39:34Z

Unblocked as upstream changes have landed... just dreading the rebase I'm about to make

Copilot

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

+    `registerIslands({${componentImports
+      .map(
+        ({ name, source }) =>
+          `${JSON.stringify(name)}: () => import(${JSON.stringify(source)})`


Copilot

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

AugustinMauroy · 2026-07-31T08:36:10Z

idk why but when I take a page an scroll I have some lag spike in safari 26.5.2

avivkeller requested a review from a team as a code owner July 27, 2026 23:35

vercel Bot deployed to Preview – api-docs-tooling July 27, 2026 23:36 View deployment

avivkeller force-pushed the partial-hydration-stacked-2 branch from b7881cb to 797e8af Compare July 27, 2026 23:37

vercel Bot deployed to Preview – api-docs-tooling July 27, 2026 23:38 View deployment

cursor Bot reviewed Jul 27, 2026

View reviewed changes

Comment thread packages/core/src/generators/web/ui/index.css

avivkeller changed the base branch from vite to main July 27, 2026 23:40

avivkeller added the blocked label Jul 27, 2026

avivkeller marked this pull request as draft July 27, 2026 23:48

Copilot AI review requested due to automatic review settings July 27, 2026 23:55

Copilot AI reviewed Jul 27, 2026

This comment was marked as off-topic.

Sign in to view

vercel Bot deployed to Preview – api-docs-tooling July 28, 2026 00:01 View deployment

Copilot AI review requested due to automatic review settings July 28, 2026 00:21

Copilot AI reviewed Jul 28, 2026

vercel Bot deployed to Preview – api-docs-tooling July 28, 2026 00:22 View deployment

Copilot AI review requested due to automatic review settings July 28, 2026 00:47

Copilot AI reviewed Jul 28, 2026

vercel Bot deployed to Preview – api-docs-tooling July 28, 2026 00:48 View deployment

Copilot AI review requested due to automatic review settings July 28, 2026 01:04

Copilot AI reviewed Jul 28, 2026

github-advanced-security AI found potential problems Jul 28, 2026

View reviewed changes

Comment thread packages/core/src/generators/web/utils/generate.mjs Fixed

vercel Bot deployed to Preview – api-docs-tooling July 28, 2026 01:05 View deployment

Copilot AI review requested due to automatic review settings July 28, 2026 18:23

avivkeller force-pushed the partial-hydration-stacked-2 branch from 9cefea8 to 8d3b7f5 Compare July 28, 2026 18:23

avivkeller removed the blocked label Jul 28, 2026

Copilot AI reviewed Jul 28, 2026

avivkeller marked this pull request as ready for review July 28, 2026 18:23

vercel Bot deployed to Preview – api-docs-tooling July 28, 2026 18:24 View deployment

avivkeller mentioned this pull request Jul 28, 2026

chore(ui): account for nested code elements nodejs/nodejs.org#9028

Merged

avivkeller added the blocked label Jul 28, 2026

This was linked to issues Jul 28, 2026

Don't pass pre-rendered components to the client #353

Open

Reduce memory footprint #815

Open

Copilot AI review requested due to automatic review settings July 29, 2026 18:36

Copilot AI reviewed Jul 29, 2026

vercel Bot deployed to Preview – api-docs-tooling July 29, 2026 18:37 View deployment

avivkeller removed the blocked label Jul 30, 2026

feat: partial hydration

96cebd3

Copilot AI review requested due to automatic review settings July 30, 2026 23:29

avivkeller force-pushed the partial-hydration-stacked-2 branch from f8bf410 to 96cebd3 Compare July 30, 2026 23:29

Copilot AI reviewed Jul 30, 2026

github-advanced-security AI found potential problems Jul 30, 2026

View reviewed changes

Comment thread packages/core/src/generators/web/utils/generate.mjs

`registerIslands({${componentImports

.map(

({ name, source }) =>

`${JSON.stringify(name)}: () => import(${JSON.stringify(source)})`

fixup!

7282006

Copilot AI review requested due to automatic review settings July 30, 2026 23:35

Copilot AI reviewed Jul 30, 2026

vercel Bot deployed to Preview – api-docs-tooling July 30, 2026 23:37 View deployment

avivkeller requested review from MattIPv4, bmuenzenmeyer and ovflowd July 31, 2026 02:59

avivkeller mentioned this pull request Jul 31, 2026

Possible bug on Windows 25H2 #909

Open

Uh oh!

Conversation

avivkeller commented Jul 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

cursor Bot commented Jul 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

PR Summary

Uh oh!

vercel Bot commented Jul 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

codecov Bot commented Jul 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

cursor Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Uh oh!

This comment was marked as off-topic.

Copilot AI left a comment

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Uh oh!

ovflowd commented Jul 30, 2026

Uh oh!

ovflowd commented Jul 30, 2026

Uh oh!

avivkeller commented Jul 30, 2026

Uh oh!

avivkeller commented Jul 30, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Uh oh!

AugustinMauroy commented Jul 31, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

avivkeller commented Jul 27, 2026 •

edited

Loading

cursor Bot commented Jul 27, 2026 •

edited

Loading

vercel Bot commented Jul 27, 2026 •

edited

Loading

codecov Bot commented Jul 27, 2026 •

edited

Loading